home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 1801_900 / DISK1835 / DISK1835.ZIP / QM_EDITI.HLP < prev    next >
Text File  |  1989-07-30  |  12KB  |  265 lines
  1.                           --- MenuEase EDITOR ---
  2.  
  3.  
  4.                  The active function keys are listed below
  5.  
  6. F2 Edit menu title                  F7 Undo insert,delete,move command
  7. F3 Check menu looks, set columns    F8 Insert blank space for new item
  8. F4 Send DOS command to system       F9 Move change order of items
  9. F5 Save/Load/Create menu file       F10 Delete item
  10. F6 Jam keystrokes for application
  11.  
  12. Editor Navigation Keys:
  13.  
  14.          <PgUp> selects previous menu item from left list
  15.          <PgDn> selects next menu item
  16.          <CURSOR_UP> select previous field of current menu item
  17.          <CURSOR_DOWN> select next field of current menu item
  18.          <CURSOR_RIGHT> move cursor to right in current field
  19.          <CURSOR_LEFT> move cursor to left in current field
  20.          <HOME> move cursor to left most character in field
  21.          <END> move cursor to right most character in field
  22.  
  23.  
  24.  
  25. General Information:
  26.  
  27. The editor allows you to set up control of the menu environment presented to
  28. the user and save them in a file for later use. The editor works with one
  29. menu file at a time. A menu file has the extension '.qmn'. Menu files are
  30. created after a editing session followed by a 'save' command. As a menu may
  31. call any number of other menus, a menu hierarchy may be set up easily.  No
  32. structure is enforced with the menu calling sequence, your free to use any
  33. structure you like. Each menu may have up to sixteen items, and each item
  34. can have a password associated with it.
  35.  
  36. The editor will display up to 16 menu items for you.  You can move, delete,
  37. insert menu items within this 16 item limit.  These 16 item slots are on the
  38. left side of the editor screen labeled A) - P).  Each menu item has several
  39. pieces of information associated with it.  On the right side of the screen
  40. is the editor box labeled `Menu Item Editor', here is where you can edit
  41. menu item data.  The left list gives you an overview of menu items, to
  42. select a item to edit type <PgUp> or <PgDn> and observe the highlighted text
  43. on the left.  In the `Menu Item Editor' box, displayed data will represent
  44. the menu item selected, changing in response to it.  The bottom two rows of
  45. the screen are for function key definition and special help for the current
  46. operation.
  47.  
  48.  
  49. Menu Item Fields:
  50.  
  51. These fields are within the upper right hand box.  Each of these fields
  52. pertains to the menu item.  The field prompts are listed below with their
  53. definitions
  54.  
  55.      Menu text   : Enter the text here you wish to appear in the menu
  56.                    MenuEase will not recognize an item that has no name; the
  57.                    bottom fields will be ignored if the menu text is
  58.                    missing.  This allows you to put an empty place holder in
  59.                    your menu. The empty place holder helps by spacing your
  60.                    items apart. Effective when used between every 4th or 5th
  61.                    menu item.
  62.  
  63.      Drive:\Dir  : Enter the drive:\directory where the program
  64.                    resides. Leaving this blank will keep you in the
  65.                    current drive:\directory.  If you have only one drive you
  66.                    don't have to enter the drive: prefix letter. When a menu
  67.                    item is invoked, MenuEase looks here to switch
  68.                    directories. Upon completion of the menu item MenuEase
  69.                    switches back to the original directory. If you want
  70.                    MenuEase to stay in the directory you set in this field
  71.                    without returning to the current directory, prefix the
  72.                    directory specification with a " ~ " character.
  73.  
  74.                    Example: ~c:\menu
  75.  
  76.      Password    : Enter a password for the application or menu.
  77.                    Leaving this blank will avoid the password prompt. All
  78.                    users will have the same passwords for applications (if
  79.                    the menu file is the same).
  80.  
  81.      Command#(1-7): Enter the program name, the same as in DOS.  This
  82.                    could be a *.bat,*.exe, or a *.com file plus any
  83.                    normal DOS command. Commands may also include the batch
  84.                    file flow commands, (eg. if , goto etc.). Flow commands
  85.                    are only valid in the BATCH mode of operation (the
  86.                    default).
  87.  
  88.  
  89.      NOTE: Command#1 can be prefixed with an ampersand `&' to signify
  90.      a new menu file is to be loaded or a '!' to signify a direct command.
  91.      Please see the TECHNICAL CONSIDERATIONS in the manual for more system
  92.      information on the Command #1-#7 fields.
  93.  
  94.  
  95. Loading New Menus:
  96.  
  97. To load a new menu file an ampersand '&' must prefix the file name on
  98. Command #1  : field.  The menu files all have the same extension '.qmn'.
  99. This extension is not needed when you type in the menu file name, MenuEase
  100. will append it automatically for you.
  101.  
  102. Commands #2-#7 will be executed as normal DOS commands or programs.  This
  103. allows you to switch directories, copy files etc.
  104.  
  105. Example:
  106.  
  107.         Menu text   : Utilities Menu
  108.         Directory   : c:\util
  109.         Password    : sample      ;will prompt user for the "sample"
  110.                                   ; password
  111.         Command #1  : &util       ;load menu file util.qmn
  112.         Command #2  :dir /p       ; get a directory listing
  113.         Command #3  :             ; blank here, could be used for more
  114.               :                   ; commands...
  115.               :
  116.         Command #7  :             ; blank
  117.  
  118.  
  119. Direct Commands:
  120. It is recommended that you use the Direct Command mode for implementing DOS
  121. commands.  To use MenuEase in the DIRECT MODE and keep it resident while
  122. executing commands, place a '!' prefix in front of `Command #1  :' field.
  123. Commands  #2-#7 are executed with MenuEase remaining resident as Command #1.
  124. This is useful in doing batch files, implementing a menu entry for dos
  125. commands such as 'dir', and when you know an application memory requirements
  126. takes less than:
  127.  
  128.         Memory available - 200K  > application memory requirements
  129.  
  130. Example:  You have 640k ram installed in your machine. 640K - 200K = 440K.
  131.           So you could keep MenuEase resident if your application took less
  132.           than 440K of ram.
  133.  
  134.  
  135.           
  136.                             EDIT MENU TITLE <F2>
  137.  
  138. Typing the <F2> function key pops up an input requester where you can enter
  139. a title.  The menu title will be displayed in reverse video on top and
  140. centered to the menu body.  Placing a space before and after the title text
  141. makes the title easier to read.  You can test your menu title by typing the
  142. <F3> key (after you've exited from the title input requester).
  143.  
  144. Typing <ESC>,<ENTER>, or any function key will exit you from the input
  145. requester.
  146.  
  147.  
  148.  
  149.                 TEST MENU - SHOW/SET NUMBER OF COLUMNS <F3>
  150.  
  151. The <F3> function key asks for the desired number of columns (defaults to
  152. the previously set number) for your menu.  Your allowed 1,2, or 3 columns.
  153. If you ask for too few columns, the program will increment the number of
  154. columns by 1.  If this occurs  MenuEase  will inform you with a message.
  155. Once the number of columns is set MenuEase will display the columnized menu
  156. items for you.  After looking at the displayed menu, press return to
  157. continue.  After you press return MenuEase will ask you if you want to see
  158. the columnized menu again. This will be your chance to select a different
  159. number of columns. (press 'Y' or 'y')
  160.  
  161.  
  162.  
  163.                           SYSTEM COMMAND HELP <F4>
  164.  
  165. The <F4> system command function allows you to access DOS commands directly
  166. from MenuEase.    If you would want to copy a file named "myfile.dat" to the
  167. a: drive, type <F4> and type "copy myfile.dat a:" <ENTER>.  The command will
  168. execute as if it were typed from the DOS prompt.
  169.  
  170.  
  171.  
  172.                       SAVE/LOAD/CREATE MENU FILE <F5>
  173.  
  174. All file functions use a common drive:\directory prefix defined in the
  175. configuration section. To get to the configuration screen exit the editor by
  176. typing <ESC>; "Y" to save any edits and then <F8>.
  177.  
  178. The SAVE feature is entered by typing "S" or "s" after typing <F5>. The
  179. feature allows you to save the current menu file to disk. It first prompts
  180. you for a file name with the current file name already typed in for you.
  181. Just type <ENTER> to save to the file name shown. If the file already exists
  182. MenuEase will display a YES/NO requester asking you if it's all right to
  183. overwrite it. Type "Y" or "y" to overwrite, any other key to abort the SAVE
  184. function.  If no file will be overwritten then MenuEase saves the new file
  185. with no prompt.
  186.  
  187. The LOAD function is entered by typing "L" or "l" after typing <F5>.
  188. MenuEase will then prompt you with the message `Save current menu file?',
  189. enter a "y" or "Y" to save the menu file your working on or any other key
  190. not to save the current file. The function then displays a list of all *.qmn
  191. files in the common drive:\directory of MenuEase. Presently the display is
  192. limited to 17 menu files, future versions will have 17 file window with
  193. <PgDn> <PgUp> scrolling of all *.qmn files within the common drive:
  194. \directory.   One can use the cursor keys to select a file from the list.
  195. When you  select your file, type <ENTER> to load it.  Type <ESC> to exit
  196. without loading a file.
  197.  
  198. The CREATE function is entered by typing "C" or "c" after typing <F5>. The
  199. function then displays a prompt asking for the file name to CREATE. If you
  200. leave this field blank and type <ENTER> you'll be put back into the editor
  201. with nothing changed. You can enter up to eight characters for the file
  202. name. Type <ENTER> to CREATE the typed file name, if the file exists in the
  203. common drive:\directory you'll be prompted to overwrite it with a YES/NO
  204. requester.  Type "Y" or "y" to overwrite the file, any other key to abort
  205. the CREATE function.
  206.  
  207.  
  208.                              JAM KEYBOARD <F6>
  209.  
  210. The jam keyboard function enables you to semi-automate your application.
  211. This helps you overcome layers of a menu system built into the program.
  212. MenuEase "types" in your saved keyboard sequence just before invoking the
  213. program.
  214.  
  215. Example:  You want to get to a listing of possible documents to edit within
  216. Q&A Integrated (c).  After editing the menu item, type the <F6> key. Select
  217. the 'Write' module by typing "w|" (the '|' equals a <ENTER>).  Select the
  218. 'Get File' function for all *.doc files by typing "g*.doc|".  So the total
  219. string entered at the input requester would be:  "w|g*.doc|".
  220.  
  221.  
  222.  
  223.  
  224.                         MENU ITEM COMMAND <F7 - F10>
  225.  
  226. These function keys operate on the whole menu item.  This means the Menu
  227. text,Directory,Password, and Command# 1-7 fields are affected by the
  228. following:
  229.  
  230.  
  231.                UNDO LAST MOVE, DELETE, or INSERT COMMAND <F7>
  232.  
  233. The undo command allows you to recover from the last command.  Type <F7> to
  234. restore the data base to its last state.
  235.  
  236.  
  237.                             INSERT COMMAND <F8>
  238.  
  239. The insert command will insert a blank menu item (space) at the current menu
  240. item (highlighted).  Use a blank space to separate menu items for better
  241. legibility.
  242.  
  243.  
  244.                              MOVE COMMAND <F9>
  245.  
  246. The move command allows you to move the current menu item (A - V) to another
  247. slot (A - V).  Input requesters guide you through the process.  Use the
  248. <ESC> key to quit the move function.
  249.  
  250.  
  251.                             DELETE COMMAND <F10>
  252.  
  253. The delete command deletes the current menu item.  The delete command is
  254. confirmed with a simple yes/no requester.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.